ST7789 beeldschermen en MicroPython 


Deze tekst gaat over ontwikkelbordjes met een ST7789 kleurenscherm en hoe we die gebruiken met 
MicroPython. Als voorbeeld gebruiken we twee bordjes van Lilygo: de T-Display en de T-PicoC3. De 
eerste heeft een ESP32 controller, de tweede een RP2040 en een ESP32C3 controller. Ze hebben 
allebei een ST7789 kleurenscherm. Helaas, de informatie over de aansturing van het scherm is 
onvolledig en niet echt duidelijk. 


De Controllers 

De ESP32 en de RP2040 zijn controllers met twee 32-bit processorkernen. De tweede is iets krachtiger, 
je merkt het verschil bij ingewikkelde grafische toepassingen. Het grote voordeel van de ESP32 is de 
ingebouwde netwerkfunctionaliteit: WiFi-hardware is ingebouwd en wordt ondersteund door 
MicroPython. De ESP32C3 controller op het T-PicoC3 bordje kan je gebruiken als hulpcontroller voor 
de netwerkverbinding, dat wordt niet behandeld in deze tekst. 


Het programmeren van de controllers 

Een MicroPython programma werkt met firmware, dat is een MicroPython systeembestand (de 
interpreter). Op de website van MicroPython vind je systeembestanden voor de ESP32 en de RP2040. 
Helaas je hebt dan geen ondersteuning voor het beeldscherm. De drivers voor de ST7789 op internet 
zijn moeilijk te configureren. Wij gebruiken systeembestanden van Russ Hughes. Dat zijn interpreters 
van MicroPython uitgebreid met ondersteuning voor de ST7789. Je vindt ze op de GitHub pagina van 
Russ Hughes: https://github.com/russhughes/st7789_mpy/tree/master/firmware . Ga naar de folder 
van jouw bordje. Voor de T-PicoC3 gebruik je folder T-Display RP2040, voor de T-Display folder T- 
Display ESP32. Download bestand firmware.uf2. Deze firmware is gebaseerd op de jongste versie van 
MicroPython. 


Het programmeren van de T-PicoC3 

Een USB-C stekker mag je 180° omdraaien, dat heeft meestal geen invloed op de werking van het 
systeem. Het T-Pico C3 verbindt de poort met één van de controllers naargelang de stand van de 
stekker. Op de onderkant van het bordje staan 2 LED's: brandt de blauwe LED, dan is de poort met de 
RP2040 verbonden. Draai je de stekker om, dan brandt de groene LED en is de poort met de ESP32-C3 
verbonden. Sluit de kabel aan zodat de blauwe LED brandt. 


Reset het bord terwijl je de BOOT-knop ingedrukt houdt. De RESET-knop is het knopje met aanduiding 
RUN, aan de zijkant naast het scherm. De BOOT-knop vind je aan de onderkant. Het bordje gedraagt 
zich als een extra schijfstation. 


Figuur 1: run- en boot-knop 


Kopieer firmware.uf2 naar deze schijf. 
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Figuur 2: firmware kopiëren 


De RP2040 is klaar. Reset het bordje, zonder de boot-knop en start Thonny op. In de opties kies je de 
interpreter voor de RP2040 en de USB-poort van het bordje. 
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MicroPython (Raspberry Pi Pico) 


Figuur 3: Thonny options 


Het programmeren van de T-Display 
De T-Display heeft een ESP32 controller. We programmeren die met de online ESP-tool van Espressif: 


https://espressif.github.io/esptool-js 
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Sluit het bordje aan en klik op Connect. Kies in het volgende venster de USB-poort waarop het bordje 
aangesloten is en klik op verbinding maken. 


espressif.github.io wil verbinding maken met een seriële poort 
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Terug in het hoofdvenster klik je op Bestand kiezen. Selecteer bestand firmware.uf2, zie hierboven. 
Klik op Program. Na het programmeren van de controller mag je hem resetten en start je Thonny op. 


Het gebruik van het scherm in een programma 

Het programma moet het scherm initialiseren: welke poorten het scherm? Wat is de resolutie? De 
initialisatie gebeurt in een bestand tft_config.py. Je bewaart dit in de flash van de controller. Voor de 
twee bordjes die we hier gebruiken zie je een afdruk van het bestand achteraan deze tekst. Maak het 
bestand aan en bewaar het in de flash. In een toepassing gebruik je tft_config.py met instructies: 


tft = tft_config.config(O) 
tft.init() 


Wil je tekst op het scherm, dan heb je minstens één lettertype-bestand nodig. Je vindt die op 
https://github.com/russhughes/st7789 mpy/tree/master/fonts/bitma 


In de voorbeelden hieronder gebruiken we vga1 bold _16x32.py, vgal 8x8.py en vgal _8x16.py. 
Download die bestanden en bewaar ze in de flash van de controller. 


Andere bordjes programmeren 

Op de GitHub pagina van Russ Hughes vind je nog firmware bestanden voor een heleboel ander bordjes 
met de ST7789. Bestand tft_config.py kan je zelf construeren. Ga uit van één van de vorige. Pas 
eventueel de resolutie van het scherm aan (350 en 240 in de voorbeelden) en controleer zeker de 
gebruikte GPIO-pinnen. Ga na in de documentatie van jouw bordje welke pinnen het scherm gebruikt. 


De voorbeelden 
De voorbeelden werken zonder aanpassingen op de twee bordjes: 


e _Hello.py van Russ Hughes laat een tekst een aantal maal op het scherm verschijnen. 
zie https://github.com/russhughes/st7789 mpy/blob/master/examples/hello. 
e _Graf-test.py toont enkele grafische functies. 
zie https://ia802700.us.archive.org/34/items/graf-test/graf-test. 
e _RTC-klok.py is een klok. Die gebruikt de RTC van de controller. Thonny synchroniseert de klok 
met de klok van de PC. 
zie https://ia902703.us.archive.org/6/items/rtc-klok/RTC-klok. 
e _Analoge-klok: 
zie https://ia902702.us.archive.org/2/items/analoge-klok/analoge-klok. 


Bestand tft_config.py 

Voor de T-PicoC3 
“YNTTGO T-PicoC3 RP2040 display""" 
from machine import Pin, SPI 
from time import sleep 


import st7789 


TFA 
BFA 


40 # top free area when scrolling 
40 # bottom free area when scrolling 


def config(rotation=0, buffer size=0, options=0): 
Pin(22, Pin.OUT, value=1) 


spi = SPI(O, 
baudrate=62500000, 
polarity=1, 
phase=1, 
sck=Pin(2, Pin.OUT), 
mosi=Pin(3, Pin.OUT), 
miso=None) 


Voor de T-Display 


Referenties 


e https://www.youtube.com/watch?v=FJF95bNKVFQ : een youtube film van Marc Perino over 


de aansturen van het scherm van de T-PicoC3 met de software van Russ Hughes. 


e https://github.com/russhughes/st7789 mpy : de github pagina van Russ Hughes. 
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